Almathera Ten Pack 3: CDPD 3

home *** CD-ROM | disk | FTP | other *** search

/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 026-050 / scopedisk40 / m2du371 / m2du371.docs < prev next >

Wrap

Text File | 1995-03-18 | 20KB | 525 lines

M2Du v3.71 - Greg Browne - 1821 Ocotillo, Alamogordo NM 88310 (505) 437-0807 ¯¯¯¯¯¯¯¯¯¯ DirUtil in Modula-2 - 50-1000 files CLI or WB Last modified - 11/16/88 CONTACT: CIS [72250,106] Alamo FastKode ROS (505)-437-2280 (24 hr 300-9600 baud) New Horizons (505)-437-9117 (7pm-8am 300-2400) DISCLAIMER: I am not responsible for anything! Use at your own risk! «»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«» «»«»«» ESPECIALLY See FastDIR WARNING! «»«»«» «»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«» P.D. NOTICE: This version of the executible is placed in the public domain. FREE! THANKS: To too many people to list, for their ideas and help. +++++++++++++++++ GENERAL OPERATION +++++++++++++++++ CLITail: Accepts arguments in any order, any spacing (from WB use Du.hist commands): f = "F"astDir in place. t = FastDir "T"emporary - auto turn off after each use. Manually turn on EVERY time you want to use it. i = "I"ncr max files-per-dir by 50 (multiple 'i' ok). d = "D"ecr max files-per-dir by 50 (multiple 'd' ok). b = Window to "B"ottom half of SCREEN (if INTERLACED). STARTUP Du.hist: Read the Du.tutor file for how to set up some startup commands which complement, duplicate, and expand the CLItail commands. COMMAND ACTIVATION: LEFT & RIGHT mouse button press & RELEASE over gadget (or name) to register. CONFIRMING: Messy & destructive commands need confirmation. When asked to "HIT [name] again", USE THE LEFT MOUSEBUTTON. The right mousebutton will NOT confirm actions, even those STARTED with the right mousebutton. INTERRUPTING: Multi-actions interrupt by clicking a gadget (including filewindow) with the LEFT mousebutton. Stop is AFTER current pass is complete. When the alternate pointer is visible, clicks are ONLY interrupts. Interrupt directory reads with a click in the filewindow. If directory has too many files, you will be warned. EXECUTE/RUN: DO, EDIT, & SHOWIFF execute sequentially (prevent disk grinding) until the last (or only) action. Then the RunCommand (default "run >nil: <nil:") is used. The Du.hist command #R allows you to change the default. When these finish, they do NOT re-read the directory (save more grinding when command is RUN). Use hidden 'S' gadget to re-read. TITLE BAR: nnnn/mmmm 00:00 R-00 [cccccc/cccccc] [fffffff/fffffff] tttttttt --------- ----- ---- ------------------------------------------- files 24 hr 'R' CHIPmem FASTmem TOTALmem curr/max time hist [avail/lgst] [avail/lgst] Avail item INITIAL DIRECTORY: From WorkBench - Logs into ram: From CLI - Logs into Current Dir [Specify initial directory with #A command in Du.hist] SIZING WINDOW: Normal AND 'hidden' gadget. Instantly shrink by clicking the open space below the title bar. Unshrink by clicking hanging space below the title in the tiny window. Tiny window movable - remembers where it was. DEVICE GADGETS: -> df0: df1: df2: dh0: dh1: dh2: dh3: vd0: ram: LEFT mouse = put into S with immediate 'GET'. RIGHT mouse = put into the D gadget. [Commands #0 through #8 in Du.hist can change these to ANY device name that will fit in 4 or less characters TOTAL] FILEWINDOW GADGET: Click unselected file OR dir to "select" it. Click "selected" name to "unselect" it. Most actions need "selected" things to work on. Filenames may be in RAW or alphabetically SORTED order (Case doesn't matter) depending on the hidden gadget under the 'D' (SEE Hidden Gadgets). NOTE: Any/all filenames AND/OR DIRS may be selected at once. See "HIDDEN GADGETS" for a 'HOLD' feature in display. SLIDER GADGET: Scroll filename window. If slider is filled, all files and directories are visible. /\ and \/: LEFT mouse = move 1 file in arrow direction RIGHT mouse = move 1 SCREEN in arrow direction MULTIPLE R GADGETS (HISTORY): 'R' holds a circular list of 20 strings. "R+ R-" scrolls them, and R-nn in title bar tells which one is in use. Startup looks for a file named Du.hist in the current directory, and if not found, in the S: directory. FIRST one found will be used to initialize the strings as explained in the example Du.hist file. If NEITHER found, all R gadgets will be empty. The file is just lines in plain text. A sample file with instructions is included. History changes must be typed in AND <ENTER>ed while program waits for normal gadget activity to be permanent. Remember, while commands are going on, the program only looks at gadget selection as an interrupt. Changes made during activity, OR ended without <ENTER>ing will be TEMPORARY. Then, scrolling history +- will return last saved history for that item. Experiment with it. STRING I/O GADGETS: -> R S D All are 255 characters long, but only part of string is seen. To view a long string, activate the gadget, and use arrows to move through it. (R)un holds command line info for RUN f<ile>+R. May also be used alone OR as the lead item in a command with highlighted file as tail if RUN R+f<ile> used. SEE ALSO HISTORY ABOVE AND THE 'R+ R-' button section. (S)ource holds name of the current active device or dir. LEFT mouseclick a device gadget and its goes here. CLICK, TYPE, AND <ENTER> in this gadget, and your entry will be new current device or dir. If access to it fails, the program returns to the last good active dir (or to ram: if that fails). Click the RIGHT mousebutton IN the BOX and a PARENT command is done. (D)estination holds the name of the path (filename in some cases) to use for certain GADGET functions. Clicking the RIGHT mousebutton IN the box backs the name up to its PARENT level (if any). The Message area at the bottom is NOT a gadget. HIDDEN GADGETS: Click LEFT mousebutton on LETTER 'R' or 'D' to blank contents of the box. Click LETTER 'S' for directory re-read of 'S'. RIGHT mouse on "S" toggles mode and color. Black (original color) means re-reads always display from file number 1. Green (same as device names) means re-reads try to display from the same position as last one. [For comparing similar directories or seeing changes in the middle of one.] RIGHT mouse on the "R" causes the string in the "R" gadget to be scanned. If it starts with # it will be evaluated as a setup command, otherwise it will be considered a history file, which if opened successfully, will be read as a NEW history and command file. RIGHT mouse on the "D" toggles a sorting flag ON/OFF. If OFF, the filewindow will NOT be sorted alphabetically. RIGHT mouse on the PRT:PAR:SER: device gadget will dump a file listing to whatever is showing there, including both dates and sizes. +++++++++++++++ BUTTON GADGETS: (alphabetically - sortof) Gadgets NOT alphabetic on screen +++++++++++++++ COPY (Multifile - consecutive) ---- Copy any/all selected file(s) to PATH in D (must be a valid device or dir). Multiple copy supported, copy to specific filename not supported. Checks PROTECT gadget setting. LEFT mouse = STOP if file status does not match PROTECT gadget. RIGHT mouse = SKIP that file and go on. COPYALL (CONFIRMED) (Mass file/directory copy) ------- Copy entire dir/disk contents, matching tree structure on the fly. Put base level source dir name in S and the base dest PATH in D and select COPYALL (and confirm). This copies EVERYTHING in S AND ITS SUBDIRECTORIES to D, creating directories as it goes. IF destination fills, you will have a chance to change disks and continue. LEFT mouse = Don't create Empty directories RIGHT mouse = Create exact directory structure (even empties). Specifically confirmed, DOES NOT check PROTECT setting. Ex: Copy entire disk (like COPY df0: to df1: all) type 'df0:' in S and 'df1:' in D and go. Copy devs directory Put 'df0:devs' in S and 'df1:devs' (existing OR NOT) in D, and start. Creates (if needed) destination directory, copies all files, creates df1:devs/printers (if needed) and copies all its files. COPYif (CONFIRMED) ------ Just like COPYALL, BUT with attention to ARC bit of source FILE's protection bits. If bit is CLEAR (file changed since last set) it WILL copy the file. If a DIRECTORY bit is SET it doesn't even go into that directory. ** THIS NEVER CREATES EMPTY DIRECTORIES!! ** LEFT mouse = SET source ARC bit after copy done RIGHT mouse = DON'T mess with ARC bit DELDIR (CONFIRMED) ------ DIRECTORY delete. To work, dir must be selected and EMPTY. ANY/ALL highlighted directories will be deleted if empty. LEFT mouse = stop if a directory doesn't delete. RIGHT mouse = continues EVEN if a directory doesn't delete DELETE (CONFIRMED) (Multifile - consecutive) ------ FILE delete. Any/all files currently highlighted will be deleted. Message area shows progress, and delete may be stopped by clicking left mouse button on any gadget (including filewindow). DSKCOPY (CONFIRMED) ------- Diskcopy 'S' to 'D' - BOTH MUST BE df0-df3. Corrects date so DOS won't be confused. IS Interruptible. LEFT mouse = NOVERIFY RIGHT mouse = VERIFY DSKWIPE (CONFIRMED) ------- QUICK WIPE OF disk in 'D'. MUST BE df0-df3. Writes fresh root block. LEFT mouse = NOVERIFY RIGHT mouse = VERIFY DO f+R DO R+f (Multifile - consecutive) ------ ------ RUN/EXECUTE command. DO R+f executes the 'R' contents with selected items as a tails. DO f+R executes selected items with the 'R' content as a tail. If no item is selected, both try the R gadget alone. Uses DOS Execute (like typing a command at > prompt). Also whether command is RUN or executed depends on other things (more info in first section). This is NOT like a script handler 'EXECUTE'. *DOES* INCLUDE HIGHLIGHTED DIRECTORY NAMES IN THE ACTIONS EDIT (Multifile - consecutive) ---- Start editor with selected FILEname(s) as tail(s). If no file selected, editor will be RUN with no file. Default name is "dme", but the #E command in Du.hist sets to your favorite name. FORMAT ------ FORMAT disk indicated in 'D'. MUST BE df0-df3. Names disk "New" and uses current date. DOES INSTALL as bootable. IS Interruptible. LEFT mouse = NOVERIFY RIGHT mouse = VERIFY F+ F- ----- Change #files-per-directory handled by DU. LEFT mouse = increase 50 RIGHT mouse = decrease 50. (More files = more memory used.) GETDIR (NOT DONE BY GADGET) ------ GETDIR by clicking the RIGHT mouse button over a directory name. HPRINT HTYPE PRINT TYPE ------ ----- ----- ---- ASCII/HEX file view/print. Destination of PRINT/HPRINT selected with toggle gadget PRT: (See TOGGLES/FLAGS section). Multiple hardcopy runs interrupt the same way as other functions. To scroll up & down in file during screen output, hold LEFT mouse down in upper or lower ½ of window, or use scroll bar. To move ONE LINE ONLY in either direction, click RIGHT mouse in the upper & lower ½ of the window . Click title bar to quit or interrupt an individual printout or display. Tabs expanded on 8 columns. NO color sequences or formfeeds. Line xx of xxx shown in the title bar. For PRINT this is 256 byte blocks NOT lines. NOTE: If PRINT/HPRINT selected with RIGHT mouse, formfeed will be sent after each file. INFO ---- No Gadget. Program automatically monitors disk insert/remove and changes to S and D. Redisplays name/free/used for both S & D with every change. INSTALL ------- INSTALL disk indicated in 'D'. MUST BE df0-df3. Writes fresh boot block. LEFT mouse = NOVERIFY RIGHT mouse = VERIFY MAKEDIR ------- Make dir named in the D gadget (if valid and not existing). If complete dev:path not given, dir will be made relative to the path in S. Check is made to insure you are not trying to create a directory with an already existing name (or over a file). Any and/or all directories needed to make the whole path will be created (if possible). LEFT mouse = DO re-read S when done RIGHT mouse = DON'T re-read. MOVE (Multifile - consecutive) ---- MOVE items to destination (must be path). Tries RENAME. If that fails, and 'item' is NOT a directory, tries copy-and-delete-source. DOES check state of the PROTECT gadget. LEFT mouse = STOP if item does not match PROTECT gadget status RIGHT mouse = SKIP that item and go on. *WARNING* - A bug in the ram-handler lets you rename a file in ram: to an existing name in ram: without a DOS error 203 and leaves you 2 in the same directory. Just so you will be aware, I didn't try to trap that. (* vd0: also does that! *) PARENT ------ Click RIGHT mousebutton in 'S' or 'D' box for PARENT. ROOT ---- Back up to the root of the current S or D gadget. If this fails with 'S', return to the last good current directory (or ram: as a last resort). LEFT mouse = Get ROOT of 'S' RIGHT mouse = Backup 'D' to its ROOT level RELABEL ------- Relabel disk in 'S' to NAME in 'D', both in memory and on disk. Internal. 'D' gadget cannot have ":" or "/" in it. RENAME ------ Rename FIRST selected file OR dir (alphabetically) to Name in the D gadget. Wherever practical, MOVE is faster. LEFT mouse = re-read directory (since it may be still be there) RIGHT mouse = NO re-read (old dropped, new not added even if still there). TAGALL RETAG FLIPTAG UNTAG OldNew ArcTAG WinTAG ------ ----- ------- ----- ------ ------ ------ Mass tag operations on all items in a window. (In some DU's -> TAGALL = ALL UNTAG = CLEAR) TAGALL selects ALL items. RETAG after multifile operations reselects items selected before (if they remain now). FLIPTAG reverses all tags. UNTAG clears all tags. OldNew select based on destination existence. LEFT mouse = tag files which DO exist at dest end (Old) RIGHT mouse = tag files which DO NOT exist at dest end (New). ArcTAG select items if their ARCHIVE bit is set. WinTAG select all items visible in the window. LEFT mouse = 'items' are FILES. (Except OldNew) RIGHT mouse = 'items' are DIRECTORIES. (Except OldNew) SetNOTE ------- Set filenote of FIRST HIGHLIGHTED file OR dir. Current R gadget content will be used as comment. To delete a comment, empty R gadget and SETNOTE (to null comment). ShoNOTE ------- Show filenote (if any) of FIRST HIGHLIGHTED file. Filenote will be shown in the message area. If [-no comment-] appears, file has no filenote attached to it. SetPROT ------- Set protection bits on highlighted FILE(s) OR DIR(s). LEFT mouse = work this on FIRST item found highlighted. RIGHT mouse = work this on ALL items highlighted. R gadget must hold letter(s) of bits you want SET. Does NOT consider CURRENT condition of flags - you must include ALL letters you want set. To get current status, use SHOPROT. Order of letters does NOT matter. Letters not present will have their bits CLEARED. Protection bits are (UPPER or lower case o.k.): P(ure) Set = "PURE" re-entrant file. S(cript) Set = script file for Shell A(rchive) Set = file UNchanged since bit was set. R(ead protect) Set = DENY permission (Ignored now) W(rite protect) Set = DENY permission (Ignored now) E(xecute protect) Set = DENY permission (Ignored now) D(elete protect) Set = REFUSE deletion (Honored by DOS) ShoPROT ------- Shows protection bit status on highlighted file OR directory. IF THE LETTER SHOWS, it means the bit is SET. The meaning of that is shown above. Uses current R gadget, so be careful of History items. LEFT mouse = show NEXT highlighted (and unselect) RIGHT mouse = scan quickly through ALL highlighted (and unselect) ShowIFF ------- Picture display. IF Du.hist has #S command, this external program will be on LEFT mouse and internal show routine will be accessed by RIGHT mouse, otherwise, both will use internal routine. ZAPALL ------ Mass directory-and-related-files delete. Works two ways. 1) If a directory name IS highlighted when ZAPALL is selected, it assumes you want to delete that directory AND ALL FILES AND SUBDIRECTORIES IN IT. 2) If NO directory name highlighted, it assumes you want to delete CONTENT of the directory (or device) in the S gadget, including ALL files and subdirectories, BUT NOT directory itself. (This leaves an empty, but existing, directory. Example: 1) Delete all files in df1:devs (but not df1:devs itself). Put df1:devs in S and go. This leaves an empty df1:devs as the S directory. 2) Delete its files AND IT, TOO. Put 'df1:' in S and select 'devs' with one click. Then hit ZAPALL twice (once to select ZAPALL, once to CONFIRM ZAPALL), and all the files and directories in 'devs' will be deleted, then devs will be deleted (unless it is ASSIGNed to devs:). Gives message area progress reports. Deletes files alphabetically backward, recursing into directories as encountered. Watch and see. R+ R- ----- Scroll R history. READ 'HISTORY' EXPLANATION. LEFT mouse = + RIGHT mouse = - D+f->D ------ Takes first highlighted item and ADDS it to 'D' gadget with / if needed. f->D&S ------ First does D+f->D and then does a GetDir if the item is a directory. Handy for adding a path to destination AND getting a directory all at once. Hitting RIGHT MOUSE OVER SLIDER DUPLICATES THIS BUTTON. f->R f->D ---- ---- Move FIRST highlighted file (OR directory) into indicated gadget. R->S R->D etc. ---- ---- Copy current gadget contents around. If R involved, affected history item is updated. IF S involved, it is treated like a new entry. R<->S etc. ----- Two-way swaps of gadget content. S<->D is the old SWAP command. If S is involved, it will be treated as though typed in fresh. If R gadget is involved, affected history item is updated. +++++++++++++++++++++ TOGGLE (FLAG) GADGETS - LEFT mouseclicking them toggles through modes. +++++++++++++++++++++ NORMAL/'FAST' ------------- This installs/removes the FastDIR (block access) routines. They are faster, but come at a high price. When active the warning below is IMPERATIVE!! «»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«» «» «» «» USING FASTDIR DURING ANY MULTITASKING DISK ACCESSES WHERE WRITES ARE «» «» DONE WILL (NOT MAY, BUT WILL) TRASH YOUR DISK (even your HARD DISK). «» «» "GEE, I forgot" isn't good enough, when you have to rebuild a 33 meg «» «» AM-33 disk. After you destroy a good disk or two, you will remember. «» «» «» «»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«» «» «» «» CONSIDER YOURSELF WARNED!!! Greg Browne «» «» «» «»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«» BLOCK/ERASE/REPLC ----------------- Indicates protection used for files at destination end of COPY and MOVE. (Not honored by COPYALL, COPYif, or ZAPALL, which must be confirmed.) 1. BLOCK - Don't continue if same name file EXISTS at destination. 2. ERASE - Don't care about file of same name at destination. 3. REPLC - Don't continue UNLESS file of same name EXISTS at destination. DEVICE/VOLUME ------------- Indicates what type of names S gadget will use. 1. DEVICE - df0:?? df1:?? etc. will be used. 2. VOLUME - disk names (MyVol:??) will be picked up. May be useful where one drive swaps are involved. Drawback in VOLUME mode. ASSIGNed names like devs: can't be used. Program assumes you want Volume Name of the disk that ASSIGNed device is on and goes to the root expressed as volume name. SIZES/DATES =========== Sets what to display about files. Changes when hit. 1. SIZES - byte file size will show. Dirs show <DIR>. 2. DATES - creation dates will show on files AND DIRS. SysDTE/OldDTE ============= Select date to put on copied files. 1. SysDTE - current system date goes on copies. 2. OldDTE - creation date of source file goes on copies. PRT: PAR: SER: ============== Showing item is destination for PRINT/HPRINT. (Also directorylist dump function using RIGHT mouse - see HIDDEN GADGETS) [SER: can be changed by #O (letter o) in Du.Hist. I don't use SER:, so I use #Ofile for directory lists or HPRINT output]